GXCleanupStartJob(IM:XP)

Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Application Messages

GXCleanupStartJob
QuickDraw GX sends the GXCleanupStartJob message if a message handler fails during the processing of a GXStartJob message. You can override the GXCleanupStartJob message to deallocate any storage you allocated in your override of the GXStartJob message. Your override code for GXCleanupStartJob has no parameters and returns no value. For example, you could declare your override for the GXCleanupStartJob message as follows:
void MyCleanupStartJob (void);
DESCRIPTION
QuickDraw GX sends the GXCleanupStartJob message after a message handler calls the GXCleanupStartJob function.
You need to override this message to deallocate any storage that you allocated in your override of the GXStartJob message.
The default implementation of this message disposes of memory that was allocated for the printing job.

SPECIAL CONSIDERATIONS
You never send the GXCleanupStartJob message yourself; however, you can call the GXCleanupStartJob function, which then sends this message.
You must forward the GXCleanupStartJob message to other message handlers.

SEE ALSO
The GXStartJob message is described in the previous section.
The GXCleanupStartJob function is described on page 5-36 in the chapter "Printing Functions for Message Overrides."